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Application Programming Interface 

From Wikipedia, the free encyclopedia. 

Server will be down for maintenance on 2004-05-12 from about 02:00 to 

03:00 UTC. 

An Application Programming Interface (API) is a set of definitions of the 
ways in which one piece of computer software communicates with another. It 
is a method of achieving abstraction , usually (but not necessarily) between 
lower-level and higher-level software. 

One of the primary purposes of an API is to provide a set of commonly-used 
functions — for example, to draw windows or icons on the screen. 
Programmers can then take advantage of the API by making use of its 
functionality, saving them the task of programming everything from scratch. 
APIs themselves are abstract: software that provides a certain API is often 
called the implementation of that API 

For example, one may look at the task of writing " Hello World " on a screen 
at increasing levels of abstraction: 

1. Do it all yourself: 

1 . Draw, on graph paper , the shapes of the letters H, e, 1, 1, o, W, o, 
r, 1, d. 

2. Work out a matrix of black and white squares that look like those 
letters. 

3. Devise a way to program the CPU to put this matrix into the 
display adapter's frame buffer . 

4. Set the graphics card up to scan its frame buffer to generate the 
correct signal. 

2. Use an operating system to do some of the work: 

1 . Load a data structure called a " font " provided with the operating 
system. 

2. Have the operating system display a blank window. 

3. Have the operating system draw the text "Hello World" to the 
window with the font. 

3. Use an application program (which uses an operating system) to do all 
this hard work: 

1 . Write an HTML document containing the text "Hello World" . 

2. Open the document in a Web browser such as Mozilla or Internet 
Explorer . 

Obviously, the first option requires more steps, each of them much more 
complicated than the steps in the subsequent options. In addition, it is 
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impractical to use the first approach to present a substantial amount of 
information, such as an encyclopedia article , on the screen, whereas the 
second approach makes the task easier by an order, and the third approach 
basically requires only that you type "Hello World." However, higher-level 
APIs often lose flexibility; for example, it would be much more difficult in a 
web browser to rotate text around a point with blinking outlines, something 
that could be done easily at the lower levels. This difference is a typical 
example of the trade-offs encountered by choosing to use an API. 

APIs are as essential to computers as electrical standards are to the home . 
One can plug his toaster into the wall whether he is at home or at a 
neighbour's house, because both houses conform to the standard API for an 
electrical socket . If there wasn't an API standard, one would have to bring a 
power station along to make toast! Note that there is nothing stopping 
somebody else coming up with another standard; a European toaster will not 
work in the US without a transformer , just as a program written for Microsoft 
Windows will not work directly on a UNIX system without an intermediate 
API adapter such as WINE . 

There are various design models for APIs. Interfaces intended for the fastest 
execution often consist of sets of functions , procedures , variables and data 
structures . However, other models exist as well, such as the interpreter used 
to evaluate expressions in ECMAScript/JavaScript . A good API provides a 
"black box" or abstraction layer, which prevents the programmer from 
needing to know how the functions of the API relate to the lower levels of 
abstraction. This makes it possible to redesign or improve the functions 
within the API without breaking code that relies on it. 

Two general lines of policies exist regarding publishing APIs: 

1 . Some companies guard their APIs zealously. For example, Sony makes 
its official PlayStation API available only to licensed PlayStation 
developers. This is because Sony wants to restrict how many people 
can write a PlayStation game , and wants to profit from them as much 
as possible. This is typical of companies who do not profit from the 
sale of API implementations (in this case, Sony breaks even by selling 
PlayStation consoles and takes a loss on marketing , intending to make 
it up through game royalties created by API licensing ). 

2. Other companies propagate their APIs freely. For example, Microsoft 
deliberately makes its API information public, so that software will be 
written for the Windows platform . The sale of the third-party software 
sells copies of Windows. This is typical of companies who profit from 
the sale of API implementations (in this case, Microsoft Windows , 
which is sold at a gain for Microsoft). 

Some APIs, such as the ones standard to an operating system , are 
implemented as separate code libraries that are distributed with the operating 
system. Others require software publishers to integrate the API functionality 
directly into the application. This forms another distinction in the examples 
above. Microsoft Windows APIs come with the operating system for anyone 
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to use. Software for embedded systems such as video game consoles 
generally falls into the application-integrated category. While an official 
Playstation API document may be interesting to read, it is of little use without 
its corresponding implementation , in the form of a separate library or 
developer's kit. 

An API that does not require royalties for access and usage is called "open." 
The APIs provided by Free software (such as software distributed under the 
GNU General Public License ), are open by definition, since anyone can look 
into the source of the software and figure out the API. Although usually 
authoritative " reference implementations " exist for an API (such as Microsoft 
Windows for the Win32 API), there's nothing that prevents the creation of 
additional implementations. For example, most of the Win32 API can be 
provided under a UNIX system using software called WINE . 

It is generally lawful to analyze API implementations in order to produce a 
compatible one. This technique is called reverse engineering for the purposes 
of interoperability . However, the legal situation is often ambiguous, so that 
care and legal counsel should be taken before the reverse engineering is 
carried out. For example, while APIs usually do not have an obvious legal 
status , they might include patents that may not be used until the patent holder 
gives permission . 

Example APIs 

• The PC BIOS call interface 

• Document Object Models of various applications, such as HTML 

• The Single UNIX Specification 

• The Microsoft Win32 API 

• The J2EE Java 2 Enterprise Edition APIs 

• ASPI for SCSI device interfacing 

• The Carbon and Cocoa APIs for the Macintosh OS 

• Simple Network Management Protocol ( SNMP ) 

• Universal Plug and Play (UPNP) 

• Common Object Request Broker Architecture (CORBA) 

• The various APIs which make up Microsoft 's DirectX . 

• Simple DirectMedia Layer (SDL) 

See also: 

• Ontology (computer science) 
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Application Programming Interface ==> 

Application Program Interface 

<pro gramming > (API, or "application programming interface") The interface (calling conventions) by 
which an a pplication program accesses operating system and other services. An API is defined at source 
code level and provides a level of abstraction between the application and the kernel (or other privileged 
utilities) to ensure the portability of the code. 

An API can also provide an interface between a high level language and lower level utilities and 
services which were written without consideration for the calling conventions supported by compiled 
languages. In this case, the API's main task may be the translation of parameter lists from one format to 
another and the interpretation of call-by-value and call-by-reference arguments in one or both directions. 
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